
Gen City 


This project shows you how you can use just a little bit of code to randomly generate large, diverse 
cities. 

Modders should be familiar with: 

• Functions 

• Variables 

• Loops 

• The bot tool 


We'll be walking through the code one Actor at a time: buildings, then rails, then Stage. 


The "buildings" Actor 


The "buildings" Actor contains all the code used to randomly generate a city. 




Let's look at that code first... 

Build with Layers 


All the skyscrapers in Gen City are created one layer at a time. 



build skyscraper layer floor blocktype 


o 


I 


The "build skyscraper layer" function builds a single using just two bot code blocks: 











build box at TynkerBot using with 

width: building width height^) depth: building width 


The glass windows are built by creating a hollow box of glass using the bot. 


build box at TynkerBot using floor blocktype with 

width: building width height^^ depth: building width 


The floor for the level is created by building a filled box one block tall in the same spot. 

Variables in this Function 

This function is using several variables to dictate the way it will build a layer. Here's how they're 
working: 



The "floor blocktype" parameter allows you to specify a different material for the layer. This variable 
only has a value inside the function. 



The "building width" variable is a global variable and can be used anywhere in the project. 



building width 


By defining the "building width" as a variable: 


• You can easily change the size of all the buildings in the city by changing the variable. 

• A city with a different building width will scale appropriately. 


Generate Skyscraper 


generate skyscraper 


The "generate skyscraper" function creates a random skyscraper. Here's how it works: 
1. It uses two script variables. 


script variables floor blocktype num floors Q Q 


2. Then it sets "floor blocktype" to a random blocktype. 













to item pick random 



length of 




3. It sets "num floors" to a random number. 



to pick random 


max stories 


4. It creates a skyscraper by placing skyscraper layers on top of each other. 
















5. Finally, it places a roof on top of the skyscraper using a box 1 block tall. 


build KiSI box at TynkerBot using floor blocktype with 
width: building width height:depth: building width 


Variables in this Function 



"max stories" is a global variable and can be used anywhere in the project. 



By defining the "max stories" as a variable, you can make your cities taller or shorter by changing the 
variable. 



"floor blocktypes" is another global variable, a list that is used to pick a random blocktype for a 
skyscraper. 













Add or remove blocktypes from this list to choose what kind of blocks to use for your random 
buildings. 

Try Modifying the Code! 


Replace the code that builds the roof with this code to give each building a 50% chance of having 
rooftop garden. 


if pick random to ® then 


build box at TynkerBot using 

width: building width h eight: depth: building width 


move TynkerBot by 


i blocks 


build box at TynkerBot using join | 

width: building width height® depth: building width 

move TynkerBot by (p blocks 

move TynkerBot by tffc blocks 


fence ; L-X+j 


build box at TynkerBot using with 

width: building width height:® depth: building width -< 

else O 

build box at TynkerBot using floor blocktype with 

width: building width height^^ depth: building width 


Generate City Block 


generate city block Cf) 


The "generate city block" function creates a city block by placing 9 skyscrapers and a roadway 
around them. 







build UtlSil box at TynkerBot using 
width: block width height:^) depth: block width 


move TynkerBot by road width blocks 

move TynkerBot by road width blocks 1 

move TynkerBot BffM by blocks j 


First it places a square of road, then moves the bot to place skyscrapers in the middle of the square. 


repeat 


save TynkerBot che< 

[Tj^Tow start 

repeat |||||j^| 

■ 

generate skyscraper 


move TynkerBot | 

1 by building width + | 


blocks 


go to TynkerBot checkpoint named 


block row start 


move TynkerBot 


by building width 




blocks 


It then creates 9 random skyscrapers by placing 3 rows of 3 skyscrapers, with 1 block of empty 
space between each skyscraper. 

Generate City 


The "generate city" function creates a city from city blocks. 


generate 


Ziyi 


O 


The city is made from city blocks just like a city block is made from skyscrapers. 










repeat num city blocks deep | 


save TynkerBot checkpoint a; 

repeat num city blocks wide 


generate city block 


move TynkerBot E53 h 

y block width . road width blocks 

go to TynkerBot checkpoint named 

move TynkerBot BifffBBl bv block width - road width blocks 


Sidewalks 


Can you modify the "generate city block" function to also create sidewalks around the skyscrapers? 



You might use this code block: 


build box at TynkerBot using with 

width: block width - road width + road width heightQ depth: block width - road width + road width 












How do you need to position the bot so that the sidewalk is placed perfectly around the buildings? 
You'll need this block: 



Your "generate city block" function might look like this: 


generate city block C?) 

save TynkerBot checkpoint as 

build box at TynkerBot using 

width: block width height:Q depth: block width 


ity blo ck start 

coal block 


move TynkerBot by road width 

move TynkerBot KHM by road width 
move TynkerBot 


build IflJSg box at TynkerBot using with 

width: block width - road width + road width height^) depth: block width 


road width + road width 


forward 3 

right^yT^ 


move TynkerBot 
move TynkerBot 
repeat 

J save TynkerBot checkpoint as 
repeat Q 

generate skyscraper 

move TynkerBot 


right 


block row start 





by building width + 


blocks 




block row start 


go to TynkerBot checkpoint named 
move TynkerBot KWBIffl by building width + Q blocks 


I 1 1 


fitt 


city block start 




The "rails" Actor 




















The "rails" Actor contains all the code to build a custom railway. 

Let's take a look at that code now... 

Railway System 

The railway is generated by 5 basic functions that lay railway tracks using the bot tool. 



The "lay track forward" function: 

• Puts down a powered track 

• Moves the bot forward 1 block 









turn track left 1 / . ■ 

turn TynkerBot left I. : 
put unpowered track I 

move TynkerBot by blocks 

turn track right 

turn TynkerBot right 
put unpowered track I 

move TynkerBot by ^ blocks 


The "turn track left" and "turn track right" functions work similarly; they both: 

• Turn the bot in the correct direction 

• Put an unpowered track (only unpowered tracks can turn) 

• Move the bot forward 1 block 


lay track up (✓) 

move TynkerBot lff| by blocks 
lay track forward 



lay track forward 


The "lay track up" and "lay track down" functions both: 

• Move the bot either up or down 

• Lay track 

These functions allow the track to be placed while ascending or descending. 

Customize the Railway 
















Now that you understand how the Railway System works, you can build your own custom railway 
and create your own rides. 



Change the code blocks in the "create railway" function to make the railway the way you want. 


put unpowered track 

move TynkerBot by blocks 


Start your rail system with an unpowered track so you can place a Minecart on it without it 
automatically rolling away. 


For the rest of the railway, use these blocks in sequence and it should create a connected and 
powered railway: 


lay track forward turn track left turn track right lay track up lay track down 


For example, to lay 10 tracks in a row you can do this: 


repeat 


lay track forward 


The Stage 




Stage 


The Stage is a special Actor that represents the background of the project and exists in all Tynker 
projects. 


In this project, the Stage is used as a starting point for the code to run. Here's how it works: 








1. Code attached to the "on start" event will run when the play button is pressed. 



move TynkerBot to player 


move TynkerBot 
move TynkerBot 


save TynkerBot checkpoint as 



3. This code positions the bot in a good place to build the city and railway. The starting location for 
the bot is saved as a checkpoint for easy reference. 



4. Return the bot to the starting position, then calls the code to generate the city and create the 
railway. 


5. The "buildings" Actor also has a function that can clear away a "city sized" area by placing all air 
blocks. 



buildings 

You can use this block to delete the previous city before building a new one. 












Your might need to change the code to look like this: 




